automatic-update

This command configures the Automatic Update feature.

Syntax

(config-system)# automatic-update
(auto-update)# 

Command

Description

<Files to Upload>

For commands under automatic-update that specify the files to upload for the Automatic Update feature, see Files to Upload.

aupd-graceful-shutdown <Seconds>

Enables the graceful lock period for Automatic Update and defines the period.

aupd-interface

Assigns an IP Interface (configured in the IP Interfaces table) for the Auto-Update mechanism.

crc-check {off|regular|voice-conf-ordered}

Enables the device to run a Cyclic Redundancy Check (CRC) on the downloaded configuration file to determine whether the file content (regardless of file timestamp) has changed compared to the previously downloaded file. Depending on the CRC result, the device installs or discards the downloaded file.

regular: CRC considers order of lines in the file (i.e., same text must be on the same lines).

voice-conf-ordered: CRC ignores the order of lines in the file (i.e., same text can be on different lines).

credentials

Defines the username and password for digest (MD5 cryptographic hashing) and basic access authentication with the HTTP server on which the files to download are located for the Automatic Update feature.

default-configuration-package-password <password>

Defines the password used to protect (encrypt) the Configuration Package file when it's uploaded to the device using the Automatic Update feature (see the configuration-pkg command). If the file is not password-protected, then ignore this command.

Note: The password configured by this command is also used for protecting (encrypting) the Configuration Package file when downloading it from the device through SFTP.

http-user-agent

Defines the information sent in the HTTP User-Agent header. For more information, see http-user-agent.

max-transfer-time

Defines the file transfer timeout (minutes) for downloading a file from the provisioning server for automatic updates.

predefined-time

Defines the time of day in the format hh:mm (i.e., hour:minutes).

predefined-random-time

Defines the maximum randomization interval (in seconds) for the daily scheduled automatic update.

run

Triggers the Automatic Update feature.

Note: The command does not replace the activate command

run-on-reboot {off|on}

Enables the Automatic Update feature to run when the device restarts (or powers up).

template-files-list

Defines the type of files in the file template to download from a provisioning server for the Automatic Update process. For more information, see template-files-list.

template-url

Defines the URL address of the provisioning server on which the file types, specified in the file template using the template-files-list command are located for download for the Automatic Update process. For more information, see template-url.

tftp-block-size

Defines the TFTP block size according to RFC 2348.

update-firmware {off|on}

Enables automatic update of the device's software file (.cmp).

update-frequency-sec

Defines the interval (in minutes) between subsequent Automatic Update processes.

verify-certificate {off|on}

Enables verification of the server certificate over HTTPS. The device authenticates the certificate against the trusted root certificate store of the associated TLS Context. Only if authentication succeeds does the device allow communication.

verify-cert-subject-name {off|on}

Enables verification of the SSL Subject Name (Common Name) in the server's certificate when using HTTPS. If the server's URL contains a hostname, the device validates the server's certificate subject name (CN/SAN) against this hostname (and not IP address); otherwise, the device validates the server's certificate subject name against the server's IP address

Command Mode

Privileged User